home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / cas120.zip / CSSYSOP.DOC < prev    next >
Text File  |  1989-12-27  |  14KB  |  367 lines
  1.  
  2. File list:
  3. ==========
  4.  
  5. This document is a simple instruction to use to setup The Mycroft Casino
  6. for your RBBS.  The following files are included:
  7.  
  8.           CSSYSOP.DOC  -  SysOp documentation (this document)
  9.           CASINO.DOC   -  User documentation
  10.           CASINO.BAT   -  DOORS execution file (sample)
  11.           CSINIT.EXE   -  The initialization program (restarts a game)
  12.           CASINO.EXE   -  The executible program (will run stand-alone)
  13.           CSINFO.DAT   -  Update data (created by program)
  14.           CSPLAYER.DAT -  Update data (created by program)
  15.           CASINO.NEW   -  Message for new players
  16.           CASINO.CFG   -  Configuration file
  17.           NODES.BBS    -  A list of your comm port assignments by BBS node
  18.           PORTS.BBS    -  A list of comm port parameters for i/o support
  19.  
  20.           TIMEGEN.EXE  -  Time control file generator
  21.           TIMES.DEF    -  Sample time control file
  22.           CASINO.TIM   -  Compiled time controls (created by timegen)
  23.  
  24.  
  25. Program history:
  26. ================
  27.  
  28. 1/89    Version 1.00  -  First version.
  29. 2/89    Version 1.01  -  Fix to PCBoard 14.0 interface
  30.                          Replaced all references to credits with dollars.
  31. 3/89    Version 1.10  -  Added Horse Racing game
  32.                          Added player editor
  33.                          Much more color added
  34. 10/89   Version 1.30  -  Spitfire support added
  35.                          Local play supported for most BBSs
  36. 12/89   Version 2.00A -  Interrupt driven i/o support
  37.                          Local play supported for RBBS & QBBS (COM0)
  38.  
  39.  
  40. Configuring Casino:
  41. ===================
  42.  
  43. The file CASINO.CFG contains the configuration information.  The file
  44. has the following format:
  45.  
  46. Mycroft Systems ;BBS name
  47. CASINO.DOC      ;Full drive/path/filename for user documentation
  48. BULLET          ;Full drive/path/filename for output bulletin
  49. SYSOP           ;Login with editor privelidges
  50. Mycroft         ;Editor password
  51.  
  52. Note: The comments are not part of the file.
  53.  
  54.  
  55. Executing Casino:
  56. =================
  57.  
  58. Note: Before running casino, you must run CSINIT to initialize the data
  59.       files.  Running CSINIT when a game is in progress will restart a
  60.       new game.
  61.  
  62. To execute directly as a door, you can use the file CASINO.BAT.  The
  63. program must be executed from the directory containing all of the
  64. above listed files except that NODES.BBS must be in the RBBS directory.
  65.  
  66. Casino is invoked on of five ways.
  67.  
  68.         1. CASINO
  69.         2. CASINO node
  70.         3. CASINO node path
  71.         4. CASINO node path bbs
  72.         5. CASINO MAINTENANCE
  73.  
  74. The first is used to run Casino in local mode.  This will play as any
  75. other game on your IBM PC.  The second method is used to run Casino
  76. under the door monitor.  The node parameter is automatically supplied by
  77. the door monitor itself.  The third method is used when running as a
  78. door under RBBS 15.  The path parameter is the current full path containing
  79. the RBBS configuration files.  The node is the RBBS node number.  The
  80. node number is passed to door batch files as parameter 1.  The fourth
  81. method may be used for a variety of BBSs.  The fourth parameter is
  82. used to specify the BBS type.  Set this to:
  83.  
  84.         (empty)         for RBBS 15.x
  85.         RBBS            for RBBS 16.x
  86.         QBBS            for Quick BBS
  87.         PCBOARD         for PC-Board BBS 12.1
  88.         PCBOARD14       for PC-Board BBS 14.0
  89.         WILDCAT         for Wildcat BBS
  90.         GAP             for GAP BBS
  91.         WWIV            for WWIV BBS
  92.  
  93.  
  94. Assumed RBBS 16.x files:
  95. ========================
  96.  
  97. Casino assumes that the following files are in the directory specified
  98. by the path parameter when running directly under RBBS 16.x:
  99.  
  100.         NODES.BBS       Node definition file.
  101.  
  102.         MESSAGES        This file contains the information pertaining
  103.                         to each node on the BBS.
  104.  
  105.         DORINFOx.DEF    This file contains all of the users settings
  106.                         such as graphics, parity, baud rate, etc.
  107.  
  108.  
  109. Assumed RBBS 15.x files:
  110. ========================
  111.  
  112. Casino assumes that the following files are in the directory specified
  113. by the path parameter when running directly under RBBS 15.x:
  114.  
  115.         NODES.BBS       Node definition file.
  116.  
  117.         MESSAGES        This file contains the information pertaining
  118.                         to each node on the BBS.
  119.  
  120.         USERS           This file contains all of the users settings
  121.                         such as graphics, parity, baud rate, etc.
  122.  
  123.         PASSWRDS        This file MUST contain an entry for each security
  124.                         level allowed to run doors.  Market gets the
  125.                         users daily time limit from this file.
  126.  
  127.  
  128. Assumed Quick BBS files:
  129. ========================
  130.  
  131. Casino assumes that the following files are in the directory specified
  132. by the path parameter when running directly under Quick BBS:
  133.  
  134.         NODES.BBS       Node definition file.
  135.  
  136.         DORINFOx.DEF    This file contains all of the users settings
  137.                         such as graphics, parity, baud rate, etc.
  138.  
  139.  
  140. Assumed PC-BOARD files:
  141. =======================
  142.  
  143. Casino assumes that the following files are in the directory specified
  144. by the path parameter when running directly under PC-Board:
  145.  
  146.         NODES.BBS       Node definition file.
  147.  
  148.         PCBOARD.SYS     This file contains the information pertaining
  149.                         to the BBS node and the callers information.
  150.  
  151.  
  152.  
  153. Assumed Wildcat files:
  154. ======================
  155.  
  156. Casino assumes that the following files are in the directory specified
  157. by the path parameter when running directly under Wildcat:
  158.  
  159.         NODES.BBS       Node definition file.
  160.  
  161.         CALLINFO.BBS    This file contains all of the users settings
  162.                         such as graphics, parity, baud rate, etc.
  163.  
  164.  
  165.  
  166. Assumed GAP files:
  167. ==================
  168.  
  169. Casino assumes that the following files are in the directory specified
  170. by the path parameter when running directly under GAP BBS:
  171.  
  172.         NODES.BBS       Node definition file.
  173.  
  174.         DOOR.SYS        This file contains all of the users settings
  175.                         such as graphics, parity, baud rate, etc.
  176.  
  177.  
  178.  
  179. Assumed WWIV files:
  180. ===================
  181.  
  182. Casino assumes that the following files are in the directory specified
  183. by the path parameter when running directly under WWIV BBS:
  184.  
  185.         NODES.BBS       Node definition file.
  186.  
  187.         CHAIN.TXT       This file contains all of the users settings
  188.                         such as graphics, parity, baud rate, etc.
  189.  
  190.  
  191.  
  192. Assumed Monitor files:
  193. ======================
  194.  
  195. Casino assumes that the following files are in the local directory with
  196. the game when running under an RBBS monitor:
  197.  
  198.         NODES.BBS       Node definition file.
  199.  
  200.         TIMEOFFx.DOR    This file contains all of the users settings
  201.                         such as graphics, parity, baud rate, etc.
  202.  
  203.  
  204. Casino assumes that the following files are in directory specified in the
  205. path parameter of the TIMEOFFx.DOR file:
  206.  
  207.         USERS.DOR       Monitor users file.
  208.  
  209.         MONITOR1.EXE    This file will be executed when the program
  210.                         terminates.
  211.  
  212.  
  213. Casino will build the following files are in the local directory with
  214. the game when running under an RBBS monitor:
  215.  
  216.         POINTSx.DOR     This file contains returns the amount of time
  217.                         used in the game and a Monitor score value.
  218.  
  219.  
  220.  
  221. Local Login Options:
  222. ====================
  223.  
  224. Casino will run from a local login from the BBS in most cases.  Exceptions
  225. to this are under QBBS and PCBOARD (both versions).
  226.  
  227.  
  228. Optional I/O:
  229. =============
  230.  
  231. If you have any problems running this door you may need to customize the I/O
  232. section.  Please edit the file PORTS.BBS and place it in your main BBS directory
  233. along with NODES.BBS.  If it is not present then the default values will be
  234. used.  Note that if you are using COM5-COM8 you must modify and supply this
  235. file.
  236.  
  237. Instructions for the file format are contained within the file.
  238.  
  239.  
  240. Time Controls:
  241. ==============
  242.  
  243. Casino contains the ability to control access of the game by security level,
  244. time of day, total play time per day, total play time per game, total game
  245. count per day, and time required to wait in between games.
  246.  
  247. The time control file may be used directly under a BBS or also with the door
  248. monitor.  If not included, then only the standard time controls are used.
  249.  
  250. The time definition file is an ASCII file used to create the time control
  251. data file.  It has the following format:
  252.  
  253. :SYSOP 1000 2330                                         ; Sysops hours
  254. :LEVEL  006  007  008  008  008  008  008  008           ; Level access classes
  255. :DAYT   000  000  000  000  000  000  000  000           ; Daily time limits
  256. :DAYG   001  002  003  003  003  003  003  003           ; Daily game limits
  257. :WAIT   000  030  030  000  000  000  000  000           ; Time between games
  258. :TIME  0000  060  060  060  060  060  060  060  120      ; Per game access
  259. :TIME  0600  000  030  030  030  030  030  030  030      ; Per game access
  260. :TIME  1000  000  045  045  045  045  045  045  120      ; Per game access
  261. :TIME  1600  000  030  030  030  030  030  030  030      ; Per game access
  262. :TIME  2000  000  045  045  045  045  045  045  060      ; Per game access
  263.  
  264. The first entry defines the SysOp hours.  This controls when the player may
  265. use the page command.  These entires are expressed as HHMM.  The second entry
  266. may be smaller than the first.  As an example, ":SYSOP 0700 1900" allows the
  267. player to use the page command from 7am until 7pm.  The entry ":SYSOP 2200
  268. 0200" allows the page command to be used between 10pm and 2am.
  269.  
  270. The ":LEVEL" entry defines how different security level users have access to
  271. the game.  This line consists of 8 entries in ascending order.  Each entry
  272. corresponds to a game control level.  As an example let us consider the
  273. following entry: ":LEVEL 010 020 030 040 050 060 070 080".  Any user with
  274. a security level of less than 10 would not have access to the game.  Users
  275. with security level 10 through 19 would have level 0 privelidges.  Users
  276. with security level 20 through 29 would have level 1 privelidges, etc.
  277. Priveledges are explained below.
  278.  
  279. The ":DAYT" entry defines the maximum time in minutes each privelidge level
  280. may play the game per day.  This entry consists of 8 values each corresponding
  281. to a privelidge level in ascending order.  Each value is in minutes.  A value
  282. of 0 represents no daily time limit for that particular privelidge level.
  283.  
  284. The ":DAYG" entry defines the maximum number of times the user may enter the
  285. game on a gien day.  It consists of 8 values each corresponding to a
  286. privelidge level in ascending order.  A value of 0 represents no game limit
  287. for that particular privelidge level.
  288.  
  289. The ":WAIT" entry defines the amount of time in minutes each user must
  290. wait between entering the game.  This entry consists of 8 values each
  291. corresponding to a privelidge level in ascending order.
  292.  
  293. The ":TIME" entries define the amount of time each user may spend during a
  294. single play session.  It consists of 9 values.  The first is the time of
  295. day the period starts.  The remaining 8 are the game time limits for
  296. each of the 8 privelidge levels.  Time limits are in minutes.  A 0 value
  297. here means that the user my not play the game during that time period.
  298. Each ":TIME" entry must be in ascending time of day order.  There may be
  299. a maximum of 8 ":TIME" entries.
  300.  
  301. To build the time control file, the following command line is used:
  302.  
  303.                 TIMEGEN def_file time_file
  304.  
  305. Where def_file is the ASCII file defining all time controls and time_file
  306. is the output file that the game will read.  For Casino, use the following
  307. command line:
  308.  
  309.                 TIMEGEN times.def casino.tim
  310.  
  311.  
  312. Deleting old players:
  313. =====================
  314.  
  315. Old players are automatically deleted by Casino after 30 days of inactivity.
  316.  
  317.  
  318. SysOp controls:
  319. ===============
  320.  
  321. The SysOp has similar controls as to those provided in RBBS.  The following
  322. set of functions are available:
  323.  
  324.     Alt F1      This key will eject a user from the game by
  325.                 setting all his time to consumed.
  326.  
  327.     Right Arrow This key will add one minute of game time to
  328.                 the current users current game session.
  329.  
  330.     Left Arrow  This key will subtract one minute of game time
  331.                 from the current users current game session.
  332.  
  333.         F4      The F4 key will toggle the state of the SysOp
  334.                 annoy toggle.  Note that it is reset to its
  335.                 original state when RBBS is reentered.
  336.  
  337.         F6      The F6 key will toggle the state of the SysOp
  338.                 availability toggle.  Note that it is reset to
  339.                 its original state when RBBS is reentered.
  340.  
  341.         F9      The F9 key will toggle the state of the SysOp
  342.                 snoop toggle.  Note that it is reset to its
  343.                 original state when RBBS is reentered.
  344.  
  345.         F10     The F10 key is used to initiate CHAT mode.  This
  346.                 allows the SysOp to converse with the user via the
  347.                 keyboard.  Unlike RBBS, CHAT mode in Market does
  348.                 not support word wrap and you will need to hit the
  349.                 ENTER key ate the end of each line.
  350.  
  351.         ESC     The escape key is used to answer a user page.  It
  352.                 is also used to terminate CHAT mode.
  353.  
  354.  
  355. Epilog:
  356. =======
  357.  
  358. Please enjoy the program and feel free to contact Mycroft Systems with any
  359. comments or questions:
  360.  
  361.                                                 Thanks,
  362.  
  363.                                                 Michael W. Bayley
  364.                                                 Mycroft Systems
  365.                                                 (408)927-0105
  366.  
  367.